<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">

<head profile="http://gmpg.org/xfn/11">

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>iZeit - User Guide</title>
<link rel="stylesheet" type="text/css" href="files/main.css" />
<script type="text/javascript" src="files/jquery.js"></script>
<script type="text/javascript" src="files/thickbox.js"></script>
</head>

<body>
<div id="bannerback"><a href="http://www.izeit.nu/" id="banner">&nbsp;</a></div>
<div id="main">
    <h1>iZeit Users Guide</h1>
    <div class="notification">
      <p>An updated version of this user guide is available at the <a href="http://wiki.lime49.com/index.php?title=Izeit">Lime49 Wiki</a>.</p>
    </div>
    <h2>Contents</h2>
    <ul>
      <li><a href="#intro">Introduction</a></li>
      <li><a href="#installing">Installing iZeit</a></li>
      <li><a href="#upgrading">Upgrading</a></li>
      <li><a href="#events">Managing Events</a></li>
      <li class="nobullet"><ul>
        <li><a href="#addevent">Adding an Event</a></li>
        <li><a href="#editevent">Editing and Deleting Events</a></li>
        <li><a href="#export">Exporting</a></li>
      </ul></li>
      <li><a href="#todolist">Managing Tasks</a></li>
      <li class="nobullet"><ul>
        <li><a href="#addtask">Adding Tasks</a></li>
        <li><a href="#edittask">Editing and Deleting Tasks</a></li>
      </ul></li>
      <li><a href="#customise">Customisation</a></li>
      <li><a href="#admin">Calendar Administration</a></li>
      <li class="nobullet"><ul>
        <li><a href="#themes">Themes</a></li>
        <li><a href="#backup">Backing Up and Restoring</a></li>
      </ul></li>
      <li><a href="#blog">Blog Integration &#47; iZeit Mini</a></li>
      <li><a href="#mobile">iZeit Mobile</a></li>
      <li><a href="#support">Support</a></li>
    </ul>

    <h2><a name="intro">Introduction</a></h2>
    <p>iZeit is a professional PHP organiser and calendar which lets you manage time in your organisation. Other similar organiser software is priced between &#36;30-&#36;50, making iZeit one of the most favourable solutions available. Once you&#39;ve installed iZeit, you can log in and start customising it to suit your needs. Customising the calendar is not compulsory, you can also use it with the default settings.</p>

    <h2><a name="installing">Installing</a></h2>
    <p>To install iZeit for the first time, upload all files to your server then go to http://yourdomain/path/to/izeit/ to start the installation. You&#39;ll need your database details. </p>
    
    <h2><a name="upgrading">Upgrading</a></h2>    
    <p>To upgrade an existing version of iZeit, first upload the new files to your server, overwriting existing files. To start the upgrade, go to http://yourdomain/path/to/izeit/index.php?act=upgrade.</p>
    <p>If you want to save your current events and tasks, you&#39;ll need to create a backup from the control panel first. When you&#39;ve done this, start the upgrade by clicking &#39;Next&#39;. The backup can be restore when the upgrade is complete, but is likely to need updating in order to be compatible with the latest version. Send the backup file to <a href="&#109;&#97;&#105;&#108;&#116;&#111;:&#x64;&#x62;&#x75;&#112;&#100;&#x61;&#116;&#x65;&#x40;&#x69;&#122;&#101;&#x69;&#x74;&#46;&#x6E;&#x75;">&#100;&#x62;&#117;&#x70;&#x64;&#97;&#x74;&#101;&#64;&#x69;&#x7A;&#101;&#105;&#x74;&#x2E;&#x6E;&#x75;</a>, and you should get an updated version within a day.</p>
    
    <h2><a name="events">Managing Events</a></h2>
    <p>By default, events are shown in the month view. This lets you quickly see which days are free and which have events occuring on them. Hovering over a day will show you events occuring on that day,
    and clicking on a day in month view will take you to a more detailed view for that day. The different views available are always available at the top right hand corner of the screen in the navigation bar <span class="number">&#40;1&#41;</span>.
    You can move directly to a date by selecting it from the drop down boxes and clicking &#39;Go&#39; or by using the arrows to move the next day&#47;week&#47;month <span class="number">&#40;2&#41;</span>.</p>
    <p>Events can also be viewed as a list by clicking &#39;Event Manager&#39; in the navigation bar, then choosing either list view or expanded view. In list view, clicking the column headings &#40;Title, Start Time, Venue etc&#41; will sort the table of 
    events either alphabetically or chronologically by that field. </p>
    <table>
    <tr>
    <td><div class="caption"><a href="images/1.png" class="thickbox"><img src="images/1_t.png" alt="Month View" class="centered" width="250" height="187" /></a>
            <small>Hovering over a day will show you<br />events happening on that day.</small></div>
        </td>
    <td><div class="caption"><a href="images/2.png" class="thickbox"><img src="images/2_t.png" alt="Day View" class="centered" width="250" height="187" /></a>
            <small>Clicking on a day will take you to a<br />detailed view of that day.</small></div>
        </td>
    <td><div class="caption"><a href="images/3.png" class="thickbox"><img src="images/3_t.png" alt="Filters and Week View" class="centered" width="250" height="187" /></a>
            <small>Filters let you toggle which<br />events are shown.</small></div>
        </td>
    </tr>
    </table>


    <h2><a name="addevent">Adding an Event</a></h2>
    <p>You may need to be logged in to add an event, depending on whether the administrator has granted everyone permission to add and delete events. After logging in, click &#39;Add Event&#39; in the navigation bar.
    This will display a form for you to enter the event details. The only compulsory fields are title, start date and end date. Clicking the calendar icon next to the start or end date boxes will show a date picker <span class="number">&#40;1&#41;</span>. If the event lasts all day, leave the
    checkbox marked &#39;This event lasts all day&#39; checked, otherwise, if the event has a start time, it can be entered into the boxes in 24 hour format by unchecking the &#39;This event lasts all day&#39; box. 
    You can choose whether to make an event public or private. The same can be done for categories. If either the event or category are marked as private, the event will oly be visible to you and the adminstrator.</p>

    <p>iZeit supports almost all patterns of recurrance imaginable. These can be set by using the recurrance input fields at the bottom of the form. Once you&#39;ve entered the event details, click &#39;Save&#39; <span class="number">&#40;2&#41;</span> to save the event.</p>
    <table>
    <tr>
    <td><div class="caption"><a href="images/4.png" class="thickbox"><img src="images/4_t.png" alt="Event Manager" class="centered" width="250" height="104" /></a>
            <small>Manage events by clicking &#39;Event Manager&#39;.</small></div>
        </td>
    <td><div class="caption"><a href="images/5.png" class="thickbox"><img src="images/5_t.png" alt="Adding an Event" class="centered" width="250" height="255" /></a>
            <small>iZeit supports many recurrance patterns.</small></div>
        </td>
    </tr>
    </table>

    <h2><a name="editevent">Editing Events</a></h2>
    <p>Events can be edited or deleted by clicking on the event title anywhere in the calendar to show details of the event, then using the action buttons <span class="number">&#40;1&#41;</span>. Events can also be edited or deleted by using the list view page. Check the box next to the event to be edited&#47;deleted <span class="number">&#40;3&#41;</span>, then use the action buttons at the top of the list <span class="number">&#40;2&#41;</span> to edit or delete it. Multiple events can also be selected this way. If the event being edited is part of a series, &#39;Delete Event&#39; and &#39;Delete Series&#39; buttons will also be shown. Saving an event using the &#39;Save Series&#39; button will overwrite every event in the series with the name, description, category, venue and custom fields entered. Any changes made to single events after the series was created will be lost.</p>
    <table>
    <tr>
    <td><div class="caption"><a href="images/6.png" class="thickbox"><img src="images/6_t.png" alt="Action Buttons" class="centered" width="250" height="118" /></a>
             <small>The actions box allows you<br />to edit and delete events</small></div>
        </td>
    <td><div class="caption"><a href="images/7.png" class="thickbox"><img src="images/7_t.png" alt="Bulk Management of Events" class="centered" width="250" height="74" /></a>
            <small>iZeit supports many recurrance patterns.</small></div>
        </td>
    </tr>
    </table>

    <h2><a name="export">Exporting Events</a></h2>
    <p>The whole calendar can be exported to the open source iCal format by clicking the iCal logo &#40;shown on most event view pages&#41;. iCal files can be imported into other applications like Google calendar or Microsoft Outlook. At present, only exporting of events is possible, iZeit does not yet support importing iCal files.</p>

    <h2><a name="todolist">Managing</a> <a name="addtask">Tasks</a></h2>
    <p>Tasks are added in the same way as events. If the 'Due Date' field is left empty, the task will be marked as ongoing.</p>

    <h2><a name="edittask">Editing Tasks</a></h2>
    <p>When viewing a task, click it&#39;s title to show more information about it. Clicking the pen icon will show a form to edit the task. Tasks can also be edited from the &#39;Event Manager&#39; page. The green tick icon marks a task as complete, and the red cross deletes it.</p>
    <div class="caption"><a href="images/9.png" class="thickbox"><img src="images/9_t.png" alt="Customise Panel" class="centered" width="250" height="96" /></a>
            <small>Controls for managing tasks.</small></div>

    <h2><a name="customise">Customisation</a></h2>
    <p>iZeit can be easily customised by using the &#39;Customise&#39; menu in the navigation bar. From here, you can change settings which control the look of the calendar, such as the number of events to how per page and the first day of the week. Categories can also be managed from this menu by clcikng the &#39;Categories&#39; tab.</p>
    <div class="caption"><a href="images/10.png" class="thickbox"><img src="images/10_t.png" alt="Customise Panel" class="centered" width="250" height="189" /></a>
            <small>Settings can be changed<br />from the customisation panel.</small></div>

    <h2><a name="admin">Calendar Adminstration</a></h2>
    <p>All administration of iZeit can be performed using the web-based control panel. If you have permission, this can be accessed by clicking &#39;Control Panel&#39; in the navigation bar. As an administrator, you will be able to see events and todo items for all users. Some event fields can be disabled and custom ones can be added from the </p>

    <h2><a name="themes">Themes</a></h2>
    <p>iZeit can be easily customised by using the control panel. It comes with two themes by default but we hope to offer more for download in the future. The main colours used on the calendar page can be changed in the &#39;Themes&#39; section of the control panel. Clicking the colour wheel next to each input box will show a colour picker. Click on a colour to select it, or enter a value into the box. Colours must be either three or six digit hex values. If you&#39;re unsure about hex colours, <a href="http://www.colorschemer.com/schemes/">ColorSchemer</a> might be a good starting point. Any colours left blank will default to those set in the currently selected theme.</p>
    <div class="caption"><a href="images/8.png" class="thickbox"><img src="images/8_t.png" alt="Entering Custom Colours" class="centered" width="250" height="99" /></a>
            <small>Custom colour schemes should<br />be entered in hex format.</small></div>

    <h2><a name="backup">Backing Up and Restoring</a></h2>
    <p>The backup section of the control panel lets you make backups of the current configuration, including all events and settings. Restoring a saved backup will overwrite everything currently in the database.</p>

    <h2><a name="blog">Blog Integration &#47; iZeit Mini</a></h2>
    <p>iZeit can be easily integrated into a blog or other PHP page. First install the script, then go to http&#58;//yourdomain.com/izeit/mini.php. The code will be generated and displayed in a text box for you to copy and paste into your page. You can either use iZeit as a static calendar, or with navigation buttons so a user can move to the next or previous month. This is done using AJAX, so the page doesn&#39;t need to be refreshed.</p>
    <p>By default, the current month is displayed, but this can be changed by calling the script using the month number and year. For example&#58; <strong><em>get_month(&#39;nav&#39;,8,2006)&#59;</em></strong> would display a calendar for August 2006 with navigation buttons, whereas <strong><em>get_month(&#39;none&#39;,4,2007)&#59;</em></strong> would display April 2007 without navigation buttons. The current month is shown by calling the function without any parameters - <strong><em>get_month()&#59;</em></strong>.</p>
    <p>iZeit complies with the XHTML Transitional specification. In order to display special characters (&#0228;, &#225;, &#223;, &#0252;, &#0246;, &#0237; etc) properly, you may need to set the encoding type of your page to UTF-8 when using mini mode. This can be done by including the following META tag in the head section&#58;</p>
    <pre>
    &#60;meta http-equiv=&#34;Content-Type&#34; content=&#34;text/html; charset=utf-8&#34; &#47;&#62;
    </pre>

    <h2><a name="mobile">iZeit Mobile</a></h2>
    <p>A stripped down version of iZeit can be access by visiting http://yourdomain.com/izeit/m.php or http://yourdomain.com/izeit/m/ if you&#39;re using URL rewriting. No images are displayed, and pages are designed to load faster on mobile devices.</p>
    <p>The following access keys are available for faster navigation&#58;</p>
    <ul>
        <li><strong>1</strong> - Previous day/month</li>
        <li><strong>2</strong> - Current month</li>
        <li><strong>3</strong> - Next day/month</li>
        <li><strong>4</strong> - Go to day</li>
        <li>&nbsp;</li>
        <li><strong>0</strong> - View this help page</li>
        <li><strong>5</strong> - View today's events</li>
    </ul>

    <h2><a name="support">Support</a></h2>
    <p>If you require help with an issue not covered in this guide, <a href="http://forums.lime49.com">our forums</a> are the best place to ask. If you have an urgent query, priority support is available by emailing <a href="&#109;&#97;&#105;&#108;&#116;&#111;:&#x73;&#x75;&#x70;&#112;&#111;&#x72;&#116;&#x40;&#x69;&#x7A;&#101;&#105;&#x74;&#x2E;&#110;&#x75;">&#x73;&#x75;&#x70;&#112;&#111;&#x72;&#116;&#x40;&#x69;&#x7A;&#101;&#105;&#x74;&#x2E;&#110;&#x75;</a>.</p>

</div>
<div id="footer">Copyright &copy; 2005-2008 Harry Jennerway<br /><a href="http://www.izeit.nu">iZeit</a></div>
</body>

</html>